Contents|Previous|Next
Working with Cygnus Insight, the visual debugger

This documentation outlines the functions of the GNUPro visual debugger, Cygnus Insight, and its graphical user interface.

- Source Window
- Dialog boxes for the Source Window
- Stack window
- Registers window
- Memory window
- Watch Expressions window
- Local Variables window
- Breakpoints window
- Console window
- Function Browser window
- Threads window
- Help window

When Insight first opens, it displays the Source Window. The other windows that are invoked from the Source Window, through View menu selections or tool bar buttons have documentation in the order that they appear in the Source Window’s View menu. The Help window, for instance, is invoked from the Source Window’s Help menu.
The documentation discusses what occurs during an actual debugging session, after running the executable up to a single breakpoint set in ’`main.c`’ of our example executable program.
Source Window
When Insight first opens, it displays the Source Window.
The following documentation describes the Source Window attributes and its correlating functionality.

- Using the Source Window
- Menu bar for the Source Window
- Toolbar buttons
- Special display pane features
- Using the mouse in the display pane
- Below the horizontal scroll bar
- Load New Executable dialog box for the Source Window
- Choose GDB Command file dialog box
- Page Setup dialog box for the Source Window
- Print dialog box for the Source Window
- Target selection from the Source Window
- Global Preferences dialog box for the Source Window
- Source Preferences dialog box for the Source Window

## Using the Source Window

When Insight first opens, it displays the Source Window.
Figure 1: Source Window

Menu bar for the Source Window
There are six menu item selections: File, Run, View,Control, Preferences and Help.
The following documentation discusses the Source Window menus.

- File
- Run
- View
- Control
- Preferences
- Help

File
Figure 2: File menu

Open

Invokes the Load New Executable dialog box for the Source Window.

Source...

Invokes the Choose GDB Command file dialog box.

If using Source-Navigator with Insight, this menu item becomes Edit Source... for interoperability

Page Setup

Invokes the Page Setup dialog box for the Source Window. This option is not currently available on the Unix version.

Print Source

Invokes the Print dialog box for the Source Window. This option is not currently available on the Unix version.

Target Settings

Invokes the Target selection from the Source Window.

Exit

Closes Insight.

Run
Figure 3: Run menu

Connect target

Connects to a remote target. When you select Connect to Target the first time, the Target Selection dialog box invokes; see Target selection from the Source Window.

Download

Downloads a program to any non-native target (including simulators). If no target is attached, the Target selection dialog box opens. For using threads when downloading, see Threads window and Threads selection dialog box; also, see
Setting breakpoints on multiple threads.

Run

Runs the executable program.

View
Figure 4: View menu

Stack

Displays Stack window.

Registers

Displays Registers window.

Memory

Displays Memory window.

Watch Expressions

Displays Watch Expressions window.

Local Variables

Displays Local Variables window.

Breakpoints

Displays Breakpoints window.

Console

Displays Console window.

Function Browser

Displays Function Browser window.

Thread List

Displays the Threads window.

Control
Figure 5: Control menu

Step

Steps to next executable line of source code. Steps into called functions.

Next

Steps to next executable line of source code in current file. Steps over called functions.

Finish

Finishes execution of the current frame. If clicked while in a function, it finishes the function and returns to the line that called the function.

Continue

Continues execution until a breakpoint, watchpoint or other exception is encountered; or execution is complete.

Step Asm Inst

Steps to next assembler instruction. Steps into subroutines.

Next Asm Inst

Steps to next assembler instruction. Executes subroutines and steps to the subsequent instruction.

Preferences
Figure 6: Preferences menu

Global

Displays Global Preferences dialog box for the Source Window.

Source

Displays Source Preferences dialog box for the Source Window.

Help
Figure 7: Help menu

Help Topics

Displays Help window.

Cygnus on the Web

Links to the GNUPro Tools web page.

About GDB...

Displays About window, containing product version number, copyright and Cygnus contact information for Insight.
Figure 8: About window

Toolbar buttons
Figure 9: Run button

The Run button runs the executable. During execution the button turns into the Stop button. If you click on the Run button with no executable loaded, you invoke the Target selection from the Source Window.

Figure 10: Stop button

The Stop button will interrupt the program, provided that the underlying hardware and protocol support such interruptions. Many monitors that are connected to boards cannot interrupt programs on those boards, so the Stop button has no functionality.

Figure 11: Step button

Steps to next executable line of source code. Steps into called functions.

Figure 12: Next button

Steps to next executable line of source code in the current file. Steps over called functions.

Figure 13: Finish button

Finishes execution of the current frame.

If clicked while in a function, it finishes the function and returns to the line that called the function.

Figure 14: Continue button

Continues execution until a breakpoint, watchpoint or other exception is encountered; or execution is complete.

Figure 15: Step assembler instruction button

Invokes Step assembler instruction. Steps into subroutines.

Figure 16: Next assembler instruction button

Steps to Next assembler instruction. Executes subroutines and steps to the following instruction.

Figure 17: Registers button

The Registers button brings up the Registers window.

Figure 18: Memory button

Displays Memory window.

Figure 19: Stack button

Displays Stack window.

Figure 20: Watch Expressions button

Displays Watch Expressions window.

Figure 21: Local Variables button

Displays Local Variables window.

Figure 22: Breakpoints button

Displays Breakpoints window.

Figure 23: Console button

Displays Console window, which features a command line interface to GDB, the GNUPro debugger.

Figure 24: Program counter display frame and line number display frame

The left-hand read-only frame displays the program counter (pc) of the current frame, while the program is running.

The right-hand read-only frame displays the line number, which contains the pc, while the program is running.

Figure 25: Down stackframe button

Moves down the stack frame one level.

Figure 26: Up stackframe button

Moves up the stack frame one level.

Figure 27: Go to bottom of stackframe button

Moves to the bottom of the stack frame.

Special display pane features
The following discussion details some special features to the display panes.

- When the executable is running, the location of the current program counter is displayed as a line with a green background.
- When the executable has finished running, the background color changes to violet (browsing mode).
- When looking at a stack backtrace, the background color changes to golden yellow.

Using the mouse in the display pane
There are various uses of the mouse within the main display pane of the Source Window. Divided into two columns (see Using the mouse in the window), the display pane’s left column extends from the left edge of the display pane to the last character of the line number, while the right column extends from the last character of the line number to the right edge of the display pane.
Figure 28: Using the mouse in the window

Left display column | Right display column

Within each column, the mouse has different effects.

The following functionality is for the right column.

- With the cursor over a global or local variable, the current value of that variable displays.
- With the cursor over a pointer to a structure or class, the type of structure or class displays and the address of the structure or class displays.
- Double clicking an expression selects it.
- Right clicking an expression invokes a pop-up menu for expressions (the selected variable was the ‘lis’ expression).

Figure 29: Pop-up window for expressions

> > > Add lis to Watch

> > > > Opens the Watch Expressions window and adds a variable expression (the ‘lis’ variable shows in the examples) to the list of expressions in the window.

> > > Dump Memory at lis

> > > > Opens the Memory window, which displays a memory dump at an expression (in the example program, the ‘lis’ expression).

When the cursor is in the left column over an executable line (marked on the far left by a minus sign), it changes into a circle. When the cursor is in this state, the following functionality occurs.

> - A left click sets a breakpoint at the current line. The breakpoint appears as a red square in place of the minus sign.
> - A left click on any existing or temporary breakpoint removes that breakpoint.
> - A right click brings up a pop-up menu for setting breakpoints.

Figure 30: Pop-up menu for setting breakpoints

Continue to here

Causes the program to run up to this location, ignoring any breakpoints. Like the temporary breakpoint, this menu selection is displayed as an orange square. This selection disables all other breakpoints. When a breakpoint has been disabled, it turns from red or orange to black.

Warning!

The debugger might be expected to execute to a given location, stopping at all encountered breakpoints. This menu item currently forces execution to this location without stopping at any encountered breakpoints.

Set breakpoint here

Sets a breakpoint on the current executable line. This has the same action as left clicking on the minus sign.

Set temporary breakpoint here

Sets a temporary breakpoint on the current executable line. A temporary breakpoint is displayed as an orange square. The temporary breakpoint is automatically removed when it is hit.

Set Breakpoint on Thread(s)...

Sets a thread-specific breakpoint at the current location (see example). A right-click on a line with a breakpoint invokes a pop-up menu for deleting breakpoints.

Figure 31: Thread-specific breakpoint
Figure 32: Pop-up menu for deleting breakpoints
Delete Breakpoint

This deletes the breakpoint on the current executable line. This has the same action as left clicking on the red square.

Continue to Here

See the description for Continue to Here for Pop-up menu for setting breakpoints.

With the cursor over a line, a breakpoint opens a breakpoint information balloon (see example).

Below the horizontal scroll bar

There are four display and selection fields below the horizontal scroll bar: the status text box, the file drop-down list box, the function drop-down combo box and the code display drop-down list box.
Figure 33: Status text box

At the top of horizontal scroll bar, a text box displays the current status of the debugger (in the status box for the window depicted in Figure 33: Status text box, the message reads "Program stopped at line 19" as current status for the example’s program.
Figure 34: File drop-down list box

The drop-down list box displays all the source (.c) and header (.h) files associated with the executable. Select files by clickingthe arrow to the right of the dialog box and selecting one of the files in the list box, or by typing the file’s name directly into the dialog box.

Figure 35: Function drop-down combo box
The function drop-down list box displays all the functions in the currently selected source or header file. Select a function by clicking in the list box, or by typing into the text field above it.

Figure 36: Code display drop-down list box

Select how the code in the Source Window is displayed, as shown with the selectable formats in Figure 36: Code display drop-down list box.

SOURCE

The source code is displayed in theSource Window.

ASSEMBLY

The assembly code is displayed in the Source Window.

MIXED

The source code and the assembly code are both displayed, interspersed in the Source Window.

SRC+ASM

The source code and the assembly code are both displayed in a double paned window. The source code is displayed in the Source Window and, in a pane below the source code pane, the assembly code is displayed.

Figure 37: Search text box

By typing a character string into the search text box and pressing Enter, a forward search is done on the source file for the first instance of that character string. By pressing the Shift and Enter keys simultaneously, a backward search is done for the string. Repeatedly hitting Enter or the Shift and Enter keys simultaneously, repeat the search forward or backward in the search window. If you type "@" in the search text box and a number, the source display jumps to the line of the number specified. For instance, after having specified "@" and "6" in the search text box, the example program shows a jump to line 6 in Figure 38: Using the search text dialog box.
Figure 38: Using the search text dialog box

Dialog boxes for the Source Window
The following documentation describes the dialog boxes that are invoked from the Source Window, through the File and Preferences menu selections.

- Load New Executable dialog box for the Source Window
- Choose GDB Command file dialog box
- Target selection from the Source Window
- Global Preferences dialog box for the Source Window
- Source Preferences dialog box for the Source Window
- Page Setup dialog box for the Source Window
- Print dialog box for the Source Window

Load New Executable dialog box for the Source Window
The Load New Executable dialog box invokes by clicking the Open menu item in the file drop-down menu of the Source Window. This dialog box allows you to navigate through directories and select an executable file to be opened in the Source Window.
Figure 39: Load New Executable dialog box window

## Choose GDB Command file dialog box

The Choose GDB Command file dialog box invokes by clicking the Source menu item in the File menu of the Source Window. This dialog box allows you to navigate through directories and select a text file containing a series of GDB commands, which will open for executing at the command prompt in the Console window.
Figure 40: Choose GDB Command file dialog box

Target selection from the Source Window
The Target Selection dialog box invokes by clicking the Target Settings menu item in the File menu of the Source Window. Allowing you to select the target for the executable files to which you want to debug, the Target Selection dialog box also helps in selecting or designating other target-specific settings.
Figure 41: Target Selection dialog box window

Connection

The Connection group contains the target drop-down list box for target selection and two other fields for setting target-specific parameters.

> - Target
> The contents of this list box depend upon the specific GDB debugger configuration you have received. For a native configuration, the list contains Exec (for native execution), Remote/Serial (serial connection to a remote target) and Remote/TCP (TCP connection to a remote target).

> If GDB has been configured to include a specific hardware simulator, the target, Exec, will be replaced by target, Simulator. The names of specific hardware targets may also be included in the list, with serial, TCP or both methods of connection, depending upon the hardware.

- Baud Rate/Hostname

Allows for specifying several toggle selections.

- When a serial connection to a remote target is selected, sets the baud rate.
- When a TCP connection to a remote target is selected, this list box becomes a text edit field, renamed “Hostname,” allowing for specifying a host name.
- When Simulator is selected, this list box becomes a text edit field, renamed “Options,” allowing for specifying of options to Simulator.

- Port

For both serial and TCP connections to remote targets, the port must be designatedwith the target system requirements:

- For serial connection, Port specifies the serial port on the host machine.
- For TCP connections, Port specifies the port number on the remote target.

Run until ’main’

Sets a breakpoint at main and runs until that breakpoint is reached. On by default.

Set breakpoint at ’exit’
Set a breakpoint at the call to the ‘`exit`’ routine. On by default.

Display Download Dialog

In addition to using the status-bar, allows for displaying more extensive download status information in a dialog box. Particularly useful when doing a serial download to a remote target, this option is unchecked by default (so that the dialog box does not display).

More Options / Fewer Options
Toggles to display or hide the Run Options at the bottom of the dialog box.

Fewer Options

The four check boxes in this group set-up the actions taken, when the Run button is clicked.

- Attach to Target
Connects to a remote target.
- Download Program
Downloads an executable to a remote target.
- Run Program
Begins execution of an executable’s debugging process.
- Continue from Last Stop
Resumes execution from wherever the executable, on a remote target, last stopped in the debugging process.

### Global Preferences dialog box for the Source Window

The Global Preferences dialog box window invokes by clicking the Global menu item in the Preferences menu of the Source Window. This dialog box allows you to select the font and the type size, for displaying text.

###### Figure 42: Global Preferences dialog box window

Icons

This drop-down list box allows for choosing between the default Windows-style icon set as shown in Windows-style icon set and the basic icon set as shown in Basic icon set.

Figure 43: Windows-style icon set

Figure 44: Basic icon set

Fonts

Allows selecting font family and size.

- Fixed Font
This drop-down list box allows you to select the font for the source code display panes
- Default Font
This drop-down list box allows you to select the font for use in list boxes, buttons and other controls.
- Status bar Font
This drop-down list box allows you to select the font for the statusbar.

### Source Preferences dialog box for the Source Window

The Source Preferences dialog box helps to specify preferences of how source code appears and to reflect changes of debug settings. Use the Source menu item in the Preferences menu of the Source Window to invoke the Source Preferences dialog box.

###### Figure 45: Source Preferences dialog box

Colors

Single left-clicking any of the colored squares opens the Choose color dialog box. The Choose color dialog box allows the display colors to be modified by the user.

Debug Mode

Unless GDB has been configured to enable the setting of tracepoints, this radio button has no effect.

Variable Balloons

If Variable Balloons is on, a balloon appears displaying the value of a variable, when the mouse is placed over the variable in the Source Window. On is the default selection.

Tab Size

Sets the number of spaces for a tab character in the Source Window.

Line Numbers

Enables (by default setting) the Source Window to display line numbers.

Page Setup dialog box for the Source Window
The Page Setup dialog box window invokes by clicking the Page Setup menu item in the File menu for the Source Window. This standard dialog box allows you to make page layout selections before printing a source file.
Figure 46: Page Setup dialog box window

Print dialog box for the Source Window
The Print dialog box window invokes by clicking the Print Source menu item in the File drop-down menu of the Source Window. This dialog box allows you to select a printer and make other print specific selections, before printing a source file.
Figure 47: Printdialog box window

##

## Stack window

The Stack window displays the current state of the call Stack, where each line represents a stack frame.

###### Figure 48: Stack window

Clicking a frame selects that frame, indicated by the background of the frame turning yellow, as shown in Clicking a stack frame. The Source Window automatically updates to display the line, corresponding to the selected frame. If the frame points to an assembly instruction, the Source Window changes to display assembly code. The background of the corresponding line in the Source Window also changes to yellow.

###### Figure 49: Clicking a stack frame

## Registers window

The Registers window dynamically displays the registers and their content. The documentation for Register menu for the Register window discusses changing the properties of registers.

###### Figure 50: Registers window

- A single left click on a register will select it.
- A double click on a register allows the content of the register to be edited.

> > Hitting the escape key (Esc) will abort the editing.

## Register menu for the Register window

###### Figure 51: Register menu

Edit

This menu item has the same effect as double clicking a register. The content of the selected register may be changed. This menu item is only active when a register has been selected.

Format

This menu item calls another pop-up menu, as shown in Register format menu, allowing the content of the selected register to be displayed in Hexadecimal, Decimal, Natural, Binary, Octal, and Raw formats.

Remove from Display

This menu item removes the selected register from the window. All registers are displayed if the window is closed and reopened. This menu item is only active when a register has been selected.

Display All Registers

This menu item displays all the registers. This menu item is only active when one or more registers have been removed from display.

###### Figure 52: Register format menu

> > Hexadecimal (Hex) is the default display format.

Remove from Display

This menu item removes the selected register from the window. All registers are displayed if the window is closed and reopened. This menu item is only active when a register has been selected.

Display All Registers

This menu item displays all the registers. This menu item is only active when one or more registers have been removed from display.

## Memory window

The Memory window dynamically displays the state of memory.

###### Figure 53: Memory window

A memory location can be selected by double clicking the left mouse button with the cursor in the window. The contents of a selected memory location can be edited. See the Address menu for the Memory window.

### Address menu for the Memory window

###### Figure 54: Address menu for the Memory window

Auto Update

The contents of the Memory window are automatically updated whenever the target’s state changes. This is the default setting.

Update Now

Forces the immediate update of the Memory window’s view of the target’s memory.

Preferences

This menu item brings up the Memory Preferences dialog box.

### Memory Preferences dialog box for the Memory window

The Memory Preferences dialog box for the Memory window makes it possible to set memory options.

###### Figure 55: Memory Preferences dialog box for the Memory window

Size

Selection of the size of the individual cells displayed.

Format

Selection of the format of the memory display.

Number of Bytes

Sets the number of bytes displayed in the Memory window.

Bytes Per Row

Sets the number of bytes displayed per row.

Display ASCII

Choose to display a string representation of the memory.

Control Char

Choose the character used to display non-ASCII characters. The default character is the period.

## Watch Expressions window

The Watch Expressions window displays the name and current value of user-specified expressions.

###### Figure 56: Watch Expressions window

- Single clicking on an expression selects that expression.
- Right clicking in the display pane, while an expression is selected, calls an expression-specific Watch menu in the Watch Expressions window.

###### Figure 57: Watch menu in the Watch Expressions window

###### Figure 58: Watch menu for the Watch Expressions window

Edit

Allows the value in the expression to be edited.

Hitting the escape key (Esc) will abort the editing.

Format

This menu item brings up another pop-up menu, as shown in Value formats for the Watch Expressions window, allowing the value of the selected expression to be displayed in Hexadecimal, Decimal, Binary, and Octal formats.

###### Figure 59: Value formats for the Watch Expressions window

> > By default, pointers are displayed in hexadecimal and all other expressions are displayed as decimal.

Remove

Removes the selected expression from the watch list.

### Add Watch button for the Watch Expressions window

An expression can be typed into the text edit field at the bottom of the dialog box, as shown in the screen on the left in Using the Add Watch button for the Watch Expressions window. By pressing the Add Watch button or hitting the Enter key, the expression is added to the list, as shown in the resulting addition to the window on the right in Using the Add Watch button for the Watch Expressions window. Invalid expressions are ignored.

###### Figure 60 : Using the Add Watch button for the Watch Expressions window

### Watching registers with the Watch Expressions window

GDB allows registers to be added to the Watch Expressions window, by typing register convenience variables into the text edit field. Every register has a corresponding convenience variable. The register convenience variables consist of a dollar sign followed by the register name. The convenience variable for the program counter is `$pc`, for example. The convenience variable for the frame pointer is `$fp`.

### Casting pointers in the Watch Expressions window

Pointer values may be cast to other types and watched, represented as the type to which the pointer was cast. For example, by typing "`(struct _foo *) bar`" in the text edit field, the `bar` pointer is cast as a `struct _foo` pointer.

## Local Variables window

The Local Variables window displays the current value of all local variables.

###### Figure 61: Local Variables window

- Single clicking the mouse with the cursor over a variable selects the variable.
- Double clicking the mouse with the cursor in the Local Variables window puts the variable into edit mode.
- Single clicking the mouse with the cursor on the plus sign to the left of a structure variable displays the elements of that structure. Compare the variable structure in the window in Local Variables window with the results in Displaying the elements of a variable structure.
- Single clicking the mouse with the cursor on the minus sign to the left of an open structure closes the display of the structure elements.

Figure 62: Displaying the elements of a variable structure

### Variable menu for the Local Variables window

Figure 63: Variable menu for the Local Variables window

Edit

Allows the value of a selected variable to be edited.
Hitting the Escape key (Esc) will abort the editing.

Format

This menu item brings up another pop-up menu, as shown in Variable format menu, allowing the value of the selected variable to be displayed in the Hexadecimal, Decimal, Binary and Octal formats.

Figure 64: Variable format menu

By default, pointers are displayed in hexadecimal and all other expressions are displayed as decimal.

## Breakpoints window

The Breakpoints window displays all breakpoints that are currently set.

> Warning!
> When debugging C++ code, breakpoints and exceptions may not work and, so, the functionality of the Breakpoints window may be inoperable.

Figure 65: Breakpoints window

- Single clicking with the mouse with the cursor over a check-box for the information displayed for a breakpoint selects that breakpoint.
- Single clicking with the mouse with the cursor over a checked check box of a breakpoint disables the breakpoint. The check disappears and the red square in the Source Window turns black.
- Single clicking with the mouse with the cursor over an empty check box of a disabled breakpoint re-enables the breakpoint. The check reappears and the black square in the Source Window turns red.

### Breakpoint menu for the Breakpoints window

Figure 66: Breakpoint menu for the Breakpoints window

Normal
Temporary

This pair of menu items toggles between the normal and temporary setting of the selected breakpoint. A normal breakpoint remains valid no matter how many times it is hit. A temporary breakpoint is removed automatically the first time it is hit. A single check mark for either setting shows the state of the selected breakpoint.

When a breakpoint is set to temporary the red check mark in the check box and the red square in the Source Window turn orange, as shown by comparing Breakpoints window with Results of setting breakpoints.

Figure 67: Results of setting breakpoints

Enabled
Disabled

This pair of menu items toggles the enabled or disabled state of the selected breakpoint. The single check mark between them shows the state of the selected breakpoint.

Remove

This menu item removes the selected breakpoint.

### Global menu for the Breakpoints window

Figure 68: Global menu for the Breakpoints window

Disable All

Disables all breakpoints.

Enable All

Enables all breakpoints.

Remove All

Removes all breakpoints.

## Console window

The Console window contains the command prompt for GDB, the GNUPro debugger, allowing access to the debugger through the command-line interface. `(gdb)` is the prompt for the debugger.
Figure 69: Console window

Note: The Console window is different from the console window for the Windows operating system (which is known as the Command.com window).

## Function Browser window

The Function Browser window invokes by clicking on the Function Browser menu selection in the View drop-down menu of the Source Window.
Figure 70: Function Browser window

Filter

The Filter group at the top of the Function Browser window contains the Show if function drop-down list box and a text edit field.

Show if function
A drop-down list box (see Show if function drop-down list box) contains the four alternatives for matching the character string entered in the text edit field.

Figure 71: Show if function drop-down list box

The alternatives for matching strings in the text edit field have the following descriptions.

`starts with`

Shows functions that start with the character string in the text edit field entry.

`contains`

Shows functions that contain the character string in the text edit field entry.

`ends with`

Shows functions that end with the character string in the text edit field entry.

matches regexp

Makes the search routines use regular expression matching. For example, searching for “`^[ab].*`” will match all functions beginning with either the “a” or “b” letters.

Files

Limits the search to the highlighted files. Clicking individual file names selects or deselects that file. The list of matching files refreshes when any search parameter changes.

Hide .h files

If checked, “`.h`” header files do not display.

Select All

Selects all listed files.

Functions

Matches functions in the selected file(s).
Breakpoints

The two available buttons, Delete or Set, allow for removing or setting a breakpoint.
Delete

Removes a breakpoint previously set at the first executable line of the selected function.

Set

Sets a breakpoint at the first executable line of the selected function.

Both of these will work on any and all selected functions in the listing. If all functions are selected, they all get or lose a breakpoint.

View Source/Hide Source

Toggles to display or hide a source browser.

Figure 71: Function Browser window with source browser

## Threads window

The Threads window dynamically displays the state of threads running in the system.

> Warning!
> Threads support is not available for all systems.

The Threads window shows a system with two threads. See also Setting breakpoints and viewing local variables and Setting breakpoints on multiple threads.
Figure 72: Threads window
The Threads window displays a list of threads and/or processes. The exact contents are specific to each operating system. The Threads window consists of a list box that displays information on threads and/or processes that are part of the executable being debugged. The first column is the GDB thread number, used internally by GDB to track the thread. This number is also used by the command line interface (the Console window) when referring to threads. The rest of the columns are dependent on information coming from the operating system.
The Source Window displays the current location and source for a current thread (or process). To change the current thread, click the left mouse button on the desired thread in the Threads window and the debugger will switch contexts, updating all windows. The current thread will highlight.
When a breakpoint is set on a line or function, every thread that hits that location will stop execution and return control to the debugger. To set a breakpoint on a specific thread or threads, you need to use the Source Window. See Setting breakpoints and viewing local variables and Setting breakpoints on multiple threads.

## Help window

The Help window invokes by clicking the Help Topics menu selection in the Help drop-down menu of the Source Window. The Help window offers HTML based navigable help by topic.
Figure 73: Help window

Note:
There is currently no Help topic for the Function Browser window, since the implementation of the Function Browser window is new to Insight functionality.

See also the discussions for File menu for the Help window and Topics menu for the Help window.

### File menu for the Help window

Figure 69: File menu for the Help window

Back

Moves back one HTML help page, relative to previous forward page movements.

Forward

Moves forward one HTML help page, relative to previous back page movement.

Home

Returns to the HTML help Table of Contents home page.

Close

Closes the Help window.

### Topics menu for the Help window

Selecting a menu item invokes the Help topic’s contents, as shown in Topics menu for the Help window.
Figure 70: Topics menu for the Help window

Each menu item represents a help topic. When a menu item is selected, the content of the Help window changes to reflect the listed topic. There is currently no Helptopic for the Function Browser window or the Threads window, since their implementation is new to Insight functionality.

Top|Contents|Previous|Next